Your research is done.
Now you need to share it.

mill exports wheat sprint research into formats anyone can read — PDF for stakeholders, CSV for spreadsheets, static sites for the web. wheat creates the knowledge. mill packages it for the real world.


What is mill?

wheat is a research framework that helps you make technical decisions by collecting evidence into "claims." When your research is done, you have an HTML brief and a claims.json file.

mill takes those outputs and converts them into other formats: PDF documents you can email, CSV files you can open in Excel, Markdown you can paste into Confluence, or static sites you can deploy to GitHub Pages. It is the export layer for the grainulation ecosystem.


Quick start — 3 commands
1

Export to PDF

Turn your HTML brief into a polished PDF for email or print.

$ npx @grainulation/mill export --format pdf output/brief.html
Converting output/brief.html to PDF... Written: output/brief.pdf (142KB, 4 pages)
2

Export to CSV

Pull all claims into a spreadsheet for analysis or compliance docs.

$ npx @grainulation/mill export --format csv claims.json
Extracting 23 claims... Written: claims.csv Columns: id, type, claim, evidence_tier, confidence, source, superseded_by
3

Publish static site

Generate a deployable site from your sprint output.

$ npx @grainulation/mill publish --target static output/
Static site generated in dist/ 3 pages, all assets inlined. Deploy to GitHub Pages or S3.

From claims.json to architecture review artifacts

Your team finished a wheat sprint about database migration. The architecture review is tomorrow. You need a PDF for the meeting and a CSV for the compliance team.

Before (raw wheat output)

output/brief.html  — self-contained HTML
output/presentation.html
claims.json        — 23 typed claims

After (mill export)

output/brief.md    — clean markdown
output/brief.pdf   — 12 pages, styled
output/slides/     — 8 individual slides
1
$ npx @grainulation/mill html-to-md output/brief.html

Convert to Markdown

Turn your HTML brief into clean Markdown for Confluence, Notion, or any wiki.

✓ Converted to output/brief.md
2
$ npx @grainulation/mill build-pdf output/brief.md

Generate PDF

Produce a paginated, styled PDF from Markdown or HTML. Ready for email or print.

✓ Generated output/brief.pdf (12 pages)
3
$ npx @grainulation/mill export --format slides output/presentation.html

Export slides

Split a presentation into individual slide files for review or reordering.

✓ Exported 8 slides to output/slides/

Every format you need

One tool for all output formats. No config files, no build pipeline.

PDF Export

HTML and Markdown to PDF. Styled, paginated, ready for email or print.

CSV Export

Claims to CSV with all fields. Open in Excel, Google Sheets, or any data tool. Also exports silo knowledge packs as curated, shareable documents.

JSON-LD

Semantic web export for linked data. Machine-readable claims with full provenance.

Static Sites

Generate deployable sites from sprint output. All assets inlined, deploy anywhere.

Issue Tracker Tickets

Turn wheat recommendations into JIRA or Linear tickets. One command bridges the gap from research to roadmap. Tickets include harvest calibration scores so reviewers can see prediction confidence at a glance.

Mermaid Diagrams

Visualize claim relationships, evidence chains, and conflicts as Mermaid diagrams. See how your wheat sprint connects.


Do I need Node.js?

Yes, Node 20 or later. But your project can use any language or framework.

Do I need wheat installed?

No. mill works with any claims.json or HTML file that follows the wheat format. You can use it standalone.

What output formats are supported?

PDF, CSV, JSON-LD, static HTML sites, issue tracker tickets (JIRA/Linear), and Mermaid diagrams. All exports are self-contained with no external dependencies.